home *** CD-ROM | disk | FTP | other *** search
/ Mac-Source 1994 July / Mac-Source_July_1994.iso / C and C++ / Entertainment / tblt / tblt⁄INFO < prev    next >
Encoding:
Text File  |  1986-09-08  |  3.0 KB  |  78 lines  |  [TEXT/MACA]
  1. Notes on the source for the game of Tablut
  2. Version 1.1, September 7, 1986
  3. Brad Needham
  4.  
  5. Tablut was written in Manx Aztec C using Manx' developer's version 1.06G
  6. and Edit (of Oct 28 '84)  on a 512K, double-drive Mac (old Roms).
  7. Although some of Tablut's resources are created with rmaker,  most of its
  8. resources were created with ResEdit  and were edited with REdit.  As of
  9. this writing the source files occupy about 110K and the object files take
  10. about 36K.
  11.  
  12. To build Tablut
  13. Cd to your Tablut source directory.
  14.  
  15.     cd Tablut:tblt
  16.  
  17. Compile each .c source file in that directory.
  18.  
  19.     cc tabsh.c; cc dlog.c; cc draw.c; ....
  20.  
  21. Link all the resultant objects into a double-clickable application called 
  22. tablut.code.
  23.  
  24.     ln -m -o tablut.code sys:lib/sacroot.o *.o -lc
  25.  
  26. Run rmaker.
  27.  
  28.     sys2:bin/rmaker
  29.  
  30. Once in rmaker,  open Tablut:tblt/tablut.r.
  31. When rmaker completes, the application "tablut" will be ready to play.
  32.  
  33. Tablut Source Files
  34. This section gives a brief description of each file in the tblt folder.
  35.  
  36. name        description 
  37. ----        -----------
  38. INFO        This file
  39. board        A macpaint  file containing pictures of the board 
  40.         and pieces, along with instructions on how to modify them.
  41. tabres.res    Most of the interesting resources for Tablut.
  42.         Edit this file with REdit  or ResEdit.
  43. tablut.r    An rmaker  source file describing some other resources
  44.         (e.g., menus, strings, and controls).
  45. progerr.h    Definitions of the program-specific error message IDs
  46.         for Tablut.  See error.c.
  47. tablut.h    Common definitions and declarations for Tablut.
  48.         Nearly every Tablut source file includes this file.
  49. anim.c        Animation code.  Handles moving a piece's image, either
  50.         automatically or by tracking the mouse.
  51. cntl.c        Handles the controls for the window (buttons, scrollbar).
  52. dlog.c        Dialog window support routines.  Since this is a
  53.         general-purpose file, it contains a couple of routines
  54.         that Tablut doesn't use.
  55. draw.c        High-level window-drawing routines.  Handles update events
  56.         and drawing of the board and controls.
  57. error.c        Displays I/O- and program- specific error alerts.
  58.         Works with include/syserr.h and progerr.h.
  59. file.c        Routines to read and write game files.
  60. finder.c    Provides Tablut's interface with the finder:
  61.         opening and printing files from the finder, and directly
  62.         launching another application.
  63. fsmisc.c    Miscellaneous file routines.  General-purpose routines to
  64.         create or find a file of a specific type.
  65. grid.c, grid2.c    Routines to handle the grid abstraction of the board:
  66.         moving a piece to a given square, removing the piece on a
  67.         given square, etc.
  68. menu.c        Handles the menu interface.
  69. misc.c        Miscellaneous general-purpose support routines.
  70. move.c        Enforces the rules of piece movement and capture.
  71.         (Some rule-enforcement is also done via mouse-tracking
  72.         in anim.c.)
  73. piece.c        The nitty-gritty of drawing a piece on the screen.
  74. record.c    Maintains the memory-resident record of the current game.
  75. event.c        The main routine and main event loop.
  76. objects        A folder containing the object files and other temporaries
  77.         (just to keep them out of the way).
  78.